unicodeText

Type

property

Summary

Specifies the text in a field, represented as Unicode (double-byte characters).

Syntax

set the unicodeText of [<chunk> of] <field> to <unicodeString>

set the unicodeText of <button> to <unicodeString>

Description

Use the unicodeText property to set or get the contents of a field or button as UTF-16.

Important

As of LiveCode 7.0 the unicodeText property has been deprecated. It will continue to work as in previous versions but should not be used in new code as the existing behaviour is incompatible with the new, transparent Unicode handling (the resulting value will be treated as binary data rather than text). This functions is only useful in combination with the also-deprecated uniEncode and uniDecode function.

For fields, use the unicodeText property to display a unicode string in a field or retrieve the text displayed in a field as a unicode string.

For buttons, use the unicodeText property to set the menu contents of a button(if it is a menu) to a unicode string. To set the label of a button to a unicode string use the unicodeLabel property.

Examples

set the unicodeText of field 1 to URL "binfile:Chinese.txt"

set the unicodeText of line 4 of field 1 to mySavedText

set the unicodeText of button languages to tUnicodeLanguageList

Related

function: uniDecode, charToNum, uniEncode

glossary: property, Unicode

keyword: field

property: dragData, text, HTMLText, unicodeLabel

Compatibility and Support

Introduced

LiveCode 2.0

OS

mac

windows

linux

ios

android

Platforms

desktop

server

mobile